home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / rcs564.zip / RLOG.MAN < prev   
Text File  |  1992-10-07  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                                                   RLOG(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rlog - print log messages and other information about RCS
  9.        files
  10.  
  11. SSYYNNOOPPSSIISS
  12.        rrlloogg [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        rrlloogg prints information about RCS files.
  16.  
  17.        Pathnames matching an RCS suffix denote RCS files; all
  18.        others denote working files.  Names are paired as
  19.        explained in ccii(1).
  20.  
  21.        rrlloogg prints the following information for each RCS file:
  22.        RCS pathname, working pathname, head (i.e., the number of
  23.        the latest revision on the trunk), default branch, access
  24.        list, locks, symbolic names, suffix, total number of
  25.        revisions, number of revisions selected for printing, and
  26.        descriptive text.  This is followed by entries for the
  27.        selected revisions in reverse chronological order for each
  28.        branch.  For each revision, rrlloogg prints revision number,
  29.        author, date/time, state, number of lines added/deleted
  30.        (with respect to the previous revision), locker of the
  31.        revision (if any), and log message.  All times are
  32.        displayed in Coordinated Universal Time (UTC).  Without
  33.        options, rrlloogg prints complete information.  The options
  34.        below restrict this output.
  35.  
  36.        --LL  Ignore RCS files that have no locks set.  This is
  37.            convenient in combination with --hh, --ll, and --RR.
  38.  
  39.        --RR  Print only the name of the RCS file.  This is
  40.            convenient for translating a working pathname into an
  41.            RCS pathname.
  42.  
  43.        --hh  Print only the RCS pathname, working pathname, head,
  44.            default branch, access list, locks, symbolic names,
  45.            and suffix.
  46.  
  47.        --tt  Print the same as --hh, plus the descriptive text.
  48.  
  49.        --bb  Print information about the revisions on the default
  50.            branch, normally the highest branch on the trunk.
  51.  
  52.        --dd_d_a_t_e_s
  53.            Print information about revisions with a checkin
  54.            date/time in the ranges given by the semicolon-
  55.            separated list of _d_a_t_e_s.  A range of the form _d_1<<_d_2 or
  56.            _d_2>>_d_1 selects the revisions that were deposited
  57.            between _d_1 and _d_2 inclusive.  A range of the form <<_d
  58.            or _d>> selects all revisions dated _d or earlier.  A
  59.            range of the form _d<< or >>_d selects all revisions dated
  60.            _d or later.  A range of the form _d selects the single,
  61.  
  62.  
  63.  
  64. GNU                         1992/07/28                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                                                   RLOG(1)
  71.  
  72.  
  73.            latest revision dated _d or earlier.  The date/time
  74.            strings _d, _d_1, and _d_2 are in the free format explained
  75.            in ccoo(1).  Quoting is normally necessary, especially
  76.            for << and >>.  Note that the separator is a semicolon.
  77.  
  78.        --ll[_l_o_c_k_e_r_s]
  79.            Print information about locked revisions only.  In
  80.            addition, if the comma-separated list _l_o_c_k_e_r_s of login
  81.            names is given, ignore all locks other than those held
  82.            by the _l_o_c_k_e_r_s.  For example, rrlloogg --LL --RR --llwwfftt RRCCSS//**
  83.            prints the name of RCS files locked by the user wwfftt.
  84.  
  85.        --rr[_r_e_v_i_s_i_o_n_s]
  86.            prints information about revisions given in the comma-
  87.            separated list _r_e_v_i_s_i_o_n_s of revisions and ranges.  A
  88.            range _r_e_v_1::_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the
  89.            same branch, ::_r_e_v means revisions from the beginning
  90.            of the branch up to and including _r_e_v, and _r_e_v:: means
  91.            revisions starting with _r_e_v to the end of the branch
  92.            containing _r_e_v.  An argument that is a branch means
  93.            all revisions on that branch.  A range of branches
  94.            means all revisions on the branches in that range.  A
  95.            branch followed by a .. means the latest revision in
  96.            that branch.  A bare --rr with no _r_e_v_i_s_i_o_n_s means the
  97.            latest revision on the default branch, normally the
  98.            trunk.
  99.  
  100.        --ss_s_t_a_t_e_s
  101.            prints information about revisions whose state
  102.            attributes match one of the states given in the comma-
  103.            separated list _s_t_a_t_e_s.
  104.  
  105.        --ww[_l_o_g_i_n_s]
  106.            prints information about revisions checked in by users
  107.            with login names appearing in the comma-separated list
  108.            _l_o_g_i_n_s.  If _l_o_g_i_n_s is omitted, the user's login is
  109.            assumed.
  110.  
  111.        --VV  Print s version number.
  112.  
  113.        --VV_n Emulate RCS version _n when generating logs.  See ccoo(1)
  114.            for more.
  115.  
  116.        --xx_s_u_f_f_i_x_e_s
  117.            Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ccii(1) for
  118.            details.
  119.  
  120.        rrlloogg prints the intersection of the revisions selected
  121.        with the options --dd, --ll, --ss, and --ww, intersected with the
  122.        union of the revisions selected by --bb and --rr.
  123.  
  124. EEXXAAMMPPLLEESS
  125.            rrlloogg  --LL  --RR  RRCCSS//**
  126.            rrlloogg  --LL  --hh  RRCCSS//**
  127.  
  128.  
  129.  
  130. GNU                         1992/07/28                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                                                   RLOG(1)
  137.  
  138.  
  139.            rrlloogg  --LL  --ll  RRCCSS//**
  140.            rrlloogg  RRCCSS//**
  141.  
  142.        The first command prints the names of all RCS files in the
  143.        subdirectory RRCCSS that have locks.  The second command
  144.        prints the headers of those files, and the third prints
  145.        the headers plus the log messages of the locked revisions.
  146.        The last command prints complete information.
  147.  
  148. EENNVVIIRROONNMMEENNTT
  149.        RRCCSSIINNIITT
  150.               options prepended to the argument list, separated
  151.               by spaces.  See ccii(1) for details.
  152.  
  153. DDIIAAGGNNOOSSTTIICCSS
  154.        The exit status is zero if and only if all operations were
  155.        successful.
  156.  
  157. IIDDEENNTTIIFFIICCAATTIIOONN
  158.        Author: Walter F. Tichy.
  159.        Revision Number: 5.4; Release Date: 1992/07/28.
  160.        Copyright 1982, 1988, 1989 by Walter F. Tichy.
  161.        Copyright 1990, 1991, 1992 by Paul Eggert.
  162.  
  163. SSEEEE AALLSSOO
  164.        ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  165.        rcsmerge(1), rcsfile(5)
  166.        Walter F. Tichy, RCS--A System for Version Control,
  167.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e _& _E_x_p_e_r_i_e_n_c_e 1155, 7 (July 1985),
  168.        637-654.
  169.  
  170. BBUUGGSS
  171.        The separator for revision ranges in the --rr option used to
  172.        be -- instead of ::, but this leads to confusion when
  173.        symbolic names contain --.  For backwards compatibility
  174.        rrlloogg --rr still supports the old -- separator, but it warns
  175.        about this obsolete use.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. GNU                         1992/07/28                          3
  197.  
  198.  
  199.